home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / mint / shells / bashsrc.zoo / shell.h < prev    next >
C/C++ Source or Header  |  1991-06-05  |  7KB  |  202 lines
  1. /* shell.h -- The data structures used by the shell */
  2.  
  3. #include "config.h"
  4. #include "general.h"
  5. #include "variables.h"
  6. #include "quit.h"
  7.  
  8. #ifdef SYSV
  9. #define MAXPATHLEN 1024
  10. #endif
  11.  
  12. extern int EOF_Reached;
  13.  
  14. #define NO_PIPE -1
  15. #define REDIRECT_BOTH -2
  16. #define IS_DESCRIPTOR -1
  17.  
  18. #define NO_VARIABLE -1
  19.  
  20. /* A bunch of stuff for flow of control using setjmp () and longjmp (). */
  21.  
  22. #include <setjmp.h>
  23. extern jmp_buf top_level, catch;
  24.  
  25. #define NOT_JUMPED 0        /* Not returning from a longjmp. */
  26. #define FORCE_EOF 1        /* We want to stop parsing. */
  27. #define DISCARD 2        /* Discard current command. */
  28. #define EXITPROG 3        /* Unconditionally exit the program now. */
  29.  
  30. /* Values that can be returned by execute_command (). */
  31. #define EXECUTION_FAILURE 1
  32. #define EXECUTION_SUCCESS 0
  33.  
  34.  
  35. /* The list of characters that are quoted in double-quotes with a
  36.    backslash.  Other characters following a backslash cause nothing
  37.    special to happen. */
  38. #define slashify_in_quotes "\\`\"$"
  39.  
  40. /* All structs which contain a `next' field should have that field
  41.    as the first field in the struct.  This means that functions
  42.    can be written to handle the general case for linked lists. */
  43. typedef struct g_list {
  44.   struct g_list *next;
  45. } GENERIC_LIST;
  46.  
  47. /* Instructions describing what kind of thing to do for a redirection. */
  48. enum r_instruction { r_output_direction, r_input_direction, r_inputa_direction,
  49.              r_appending_to, r_reading_until, r_duplicating,
  50.              r_deblank_reading_until, r_close_this, r_err_and_out };
  51.  
  52. /* Command Types: */
  53. enum command_type { cm_for, cm_case, cm_while, cm_if, cm_simple,
  54.             cm_connection, cm_function_def, cm_until, cm_group };
  55.  
  56. /* A structure which represents a word. */
  57. typedef struct word_desc {
  58.   char *word;            /* Zero terminated string. */
  59.   int dollar_present;        /* Non-zero means dollar sign present. */
  60.   int quoted;            /* Non-zero means single, double, or back quote
  61.                    or backslash is present. */
  62.   int assignment;        /* Non-zero means that this word contains an assignment. */
  63. } WORD_DESC;
  64.  
  65. /* A linked list of words. */
  66. typedef struct word_list {
  67.   struct word_list *next;
  68.   WORD_DESC *word;
  69. } WORD_LIST;
  70.  
  71.  
  72. /* **************************************************************** */
  73. /*                                    */
  74. /*            Shell Command Structs                */
  75. /*                                    */
  76. /* **************************************************************** */
  77.  
  78. /* What a redirection descriptor looks like.  If FLAGS is IS_DESCRIPTOR,
  79.    then we use REDIRECTEE.DEST, else we use the file specified. */
  80. typedef struct redirect {
  81.   struct redirect *next;    /* Next element, or NULL. */
  82.   int redirector;        /* Descriptor to be redirected. */
  83.   int flags;            /* Flag value for `open'. */
  84.   enum r_instruction  instruction; /* What to do with the information. */
  85.   union {
  86.     int dest;            /* Place to redirect REDIRECTOR to, or ... */
  87.     WORD_DESC *filename;    /* filename to redirect to. */
  88.   } redirectee;
  89.   char *here_doc_eof;        /* The word that appeared in <<foo. */
  90. } REDIRECT;
  91.  
  92. /* An element used in parsing.  A single word or a single redirection.
  93.    This is an ephemeral construct. */
  94. typedef struct element {
  95.   WORD_DESC *word;
  96.   REDIRECT *redirect;
  97. } ELEMENT;
  98.  
  99. /* What a command looks like. */
  100. typedef struct command {
  101.   enum command_type type;    /* FOR CASE WHILE IF CONNECTION or SIMPLE. */
  102.   int subshell;            /* Non-zero means execute in a subshell. */
  103.   REDIRECT *redirects;        /* Special redirects for FOR CASE, etc. */
  104.   union {
  105.     struct for_com *For;
  106.     struct case_com *Case;
  107.     struct while_com *While;
  108.     struct if_com *If;
  109.     struct connection *Connection;
  110.     struct simple_com *Simple;
  111.     struct function_def *Function_def;
  112.     struct group_com *Group;
  113.   } value;
  114. } COMMAND;
  115.  
  116. /* Structure used to represent the CONNECTION type. */
  117. typedef struct connection {
  118.   COMMAND *first;        /* Pointer to the first command. */
  119.   COMMAND *second;        /* Pointer to the second command. */
  120.   int connector;        /* What separates this command from others. */
  121. } CONNECTION;
  122.  
  123. /* Structures used to represent the CASE command. */
  124.  
  125. /* Pattern/action structure for CASE_COM. */
  126. typedef struct pattern_list {
  127.   struct pattern_list *next;    /* The next clause to try in case this one failed. */
  128.   WORD_LIST *patterns;        /* Linked list of patterns to test, one after each other. */
  129.   COMMAND *action;        /* Thing to execute if one of the patterns match. */
  130. } PATTERN_LIST;
  131.  
  132. /* The CASE command. */
  133. typedef struct case_com {
  134.   WORD_DESC *word;        /* the thing to test. */
  135.   PATTERN_LIST *clauses;    /* the clauses to test against, or NULL. */
  136. } CASE_COM;
  137.  
  138. /* FOR command. */
  139. typedef struct for_com {
  140.   WORD_DESC *name;        /* The variable name to get mapped over. */
  141.   WORD_LIST *map_list;        /* The things to map over.  This is never NULL. */
  142.   COMMAND *action;        /* The action to execute.
  143.                    During execution, NAME is bound to successive
  144.                    members of MAP_LIST. */
  145. } FOR_COM;
  146.  
  147. /* IF command. */
  148. typedef struct if_com {
  149.   COMMAND *test;        /* Thing to test. */
  150.   COMMAND *true_case;        /* What to do if the test returned non-zero. */
  151.   COMMAND *false_case;        /* What to do if the test returned zero. */
  152. } IF_COM;
  153.  
  154. /* WHILE command. */
  155. typedef struct while_com {
  156.   COMMAND *test;        /* Thing to test. */
  157.   COMMAND *action;        /* Thing to do while test is non-zero. */
  158. } WHILE_COM;
  159.  
  160. /* The "simple" command.  Just a collection of words and redirects. */
  161. typedef struct simple_com {
  162.   WORD_LIST *words;        /* The program name, the arguments, variable assignments, etc. */
  163.   REDIRECT *redirects;        /* Redirections to perform. */
  164. } SIMPLE_COM;
  165.  
  166. /* The "function_def" command.  This isn't really a command, but it is
  167.    represented as such for now.  If the function def appears within 
  168.    `(' `)' the parser tries to set the SUBSHELL bit of the command.  That
  169.    means that FUNCTION_DEF has to be run through the executor.  Maybe this
  170.    command should be defined in a subshell.  Who knows or cares. */
  171. typedef struct function_def {
  172.   WORD_DESC *name;
  173.   COMMAND *command;
  174. } FUNCTION_DEF;
  175.  
  176. /* A command that is `grouped' allows pipes to take effect over
  177.    the entire command structure. */
  178. typedef struct group_com {
  179.   COMMAND *command;
  180. } GROUP_COM;
  181.   
  182. /* Forward declarations of functions called by the grammer. */
  183. extern REDIRECT *make_redirection ();
  184. extern WORD_LIST *make_word_list ();
  185. extern WORD_DESC *make_word ();
  186.  
  187. extern COMMAND
  188.   *make_for_command (), *make_case_command (), *make_if_command (),
  189.   *make_while_command (), *command_connect (), *make_simple_command (),
  190.   *make_function_def (), *clean_simple_command (), *make_until_command (),
  191.   *make_group_command ();
  192.  
  193.  
  194. extern PATTERN_LIST *make_pattern_list ();
  195. extern COMMAND *global_command, *copy_command ();
  196.  
  197. extern char **shell_environment;
  198. extern WORD_LIST *rest_of_args;
  199.  
  200. /* Generalized global variables. */
  201. extern int executing, login_shell;
  202.